home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / ifl / TIFFWriteEncodedTile.z / TIFFWriteEncodedTile
Text File  |  1998-10-20  |  5KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeEEEEnnnnccccooooddddeeeeddddTTTTiiiilllleeee((((3333TTTT))))             IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFWritedEncodedTile - compress and write a tile of data to an open TIFF
  10.      file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  14.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeEEEEnnnnccccooooddddeeeeddddTTTTiiiilllleeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, ttttttttiiiilllleeee____tttt ttttiiiilllleeee,,,, ttttddddaaaattttaaaa____tttt bbbbuuuuffff,,,,
  15.      ttttssssiiiizzzzeeee____tttt ssssiiiizzzzeeee))))
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      Compress _s_i_z_e bytes of raw data from _b_u_f and aaaappppppppeeeennnndddd the result to the end
  19.      of the specified tile.  Note that the value of _t_i_l_e is a ``raw tile
  20.      number.''  That is, the caller must take into account whether or not the
  21.      data are organized in separate places (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).
  22.      _T_I_F_F_C_o_m_p_u_t_e_T_i_l_e automatically does this when converting an (x,y,z,sample)
  23.      coordinate quadruple to a tile number.
  24.  
  25. NNNNOOOOTTTTEEEESSSS
  26.      The library writes encoded data using the native machine byte order.
  27.      Correctly implemented TIFF readers are expected to do any necessary
  28.      byte-swapping to correctly process image data with BitsPerSample greater
  29.      than 8.
  30.  
  31. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  32.      -1 is returned if an error was encountered.  Otherwise, the value of _s_i_z_e
  33.      is returned.
  34.  
  35. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  36.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  37.  
  38.      %%%%ssss:::: FFFFiiiilllleeee nnnnooootttt ooooppppeeeennnn ffffoooorrrr wwwwrrrriiiittttiiiinnnngggg.  The file was opened for reading, not
  39.      writing.
  40.  
  41.      CCCCaaaannnn nnnnooootttt wwwwrrrriiiitttteeee ttttiiiilllleeeessss ttttoooo aaaa ssssttttrrrriiiippppppppeeeedddd iiiimmmmaaaaggggeeee.  The image is assumed to be
  42.      organized in strips because neither of the _T_i_l_e_W_i_d_t_h or _T_i_l_e_L_e_n_g_t_h tags
  43.      have been set with _T_I_F_F_S_e_t_F_i_e_l_d(3T).
  44.  
  45.      %%%%ssss:::: MMMMuuuusssstttt sssseeeetttt """"IIIImmmmaaaaggggeeeeWWWWiiiiddddtttthhhh"""" bbbbeeeeffffoooorrrreeee wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa.  The image's width has not
  46.      be set before the first write.  See _T_I_F_F_S_e_t_F_i_e_l_d(3T) for information on
  47.      how to do this.
  48.  
  49.      %%%%ssss:::: MMMMuuuusssstttt sssseeeetttt """"PPPPllllaaaannnnaaaarrrrCCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn"""" bbbbeeeeffffoooorrrreeee wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa.  The organization
  50.      of data has not be defined before the first write.  See _T_I_F_F_S_e_t_F_i_e_l_d(3T)
  51.      for information on how to do this.
  52.  
  53.      %%%%ssss:::: NNNNoooo ssssppppaaaacccceeee ffffoooorrrr ttttiiiilllleeee aaaarrrrrrrraaaayyyyssss"""".  There was not enough space for the arrays
  54.      that hold tile offsets and byte counts.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_W_r_i_t_e_T_i_l_e(3T), _T_I_F_F_W_r_i_t_e_R_a_w_T_i_l_e(3T)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.